<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>设置用户自定义会话存储函数</title>
 </head>
 <body class="docs"><div id="layout">
  <div id="layout-content"><div id="function.session-set-save-handler" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">session_set_save_handler</h1>
  <p class="verinfo">(PHP 4, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">session_set_save_handler</span> &mdash; <span class="dc-title">设置用户自定义会话存储函数</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.session-set-save-handler-description">
  <h3 class="title">说明</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>session_set_save_handler</strong></span>
    ( <span class="methodparam"><span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span> <code class="parameter">$open</code></span>
   , <span class="methodparam"><span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span> <code class="parameter">$close</code></span>
   , <span class="methodparam"><span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span> <code class="parameter">$read</code></span>
   , <span class="methodparam"><span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span> <code class="parameter">$write</code></span>
   , <span class="methodparam"><span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span> <code class="parameter">$destroy</code></span>
   , <span class="methodparam"><span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span> <code class="parameter">$gc</code></span>
   [, <span class="methodparam"><span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span> <code class="parameter">$create_sid</code></span>
   [, <span class="methodparam"><span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span> <code class="parameter">$validate_sid</code></span>
   [, <span class="methodparam"><span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span> <code class="parameter">$update_timestamp</code></span>
  ]]] ) : <span class="type">bool</span></div>

  <p class="para rdfs-comment">
   自 PHP 5.4 开始，可以使用下面的方式来注册自定义会话存储函数：
  </p>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>session_set_save_handler</strong></span>
    ( <span class="methodparam"><span class="type">object</span> <code class="parameter">$sessionhandler</code></span>
   [, <span class="methodparam"><span class="type">bool</span> <code class="parameter">$register_shutdown</code><span class="initializer"> = <strong><code>TRUE</code></strong></span></span>
  ] ) : <span class="type">bool</span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>session_set_save_handler()</strong></span> 设置用户自定义
   会话存储函数。
   如果想使用 PHP 内置的会话存储机制之外的方式，
   可以使用本函数。
   例如，可以自定义会话存储函数来将会话数据存储到数据库。
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.session-set-save-handler-parameters">
  <h3 class="title">参数</h3>
  <p class="para">
   本函数有 2 种原型：
   <dl>

    
     <dt>
<code class="parameter">sessionhandler</code></dt>

     <dd>

      <p class="para">
       实现了
       <span class="interfacename"><a href="class.sessionhandlerinterface.html" class="interfacename">SessionHandlerInterface</a></span>，
       <span class="interfacename"><strong class="interfacename">SessionIdInterface</strong></span> 和/或
       <span class="interfacename"><strong class="interfacename">SessionUpdateTimestampHandlerInterface</strong></span>
       接口的对象，
       例如 <a href="class.sessionhandler.html" class="classname">SessionHandler</a>。
       自 PHP 5.4 之后可以使用。
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">register_shutdown</code></dt>

     <dd>

      <p class="para">
       将函数 <span class="function"><a href="session_write_close.html" class="function">session_write_close()</a></span> 注册为
       <span class="function"><a href="register_shutdown_function.html" class="function">register_shutdown_function()</a></span> 函数。
      </p>
     </dd>

    
   </dl>


   或者

   <dl>

    
     <dt>
<code class="parameter">open(string $savePath, string $sessionName)</code></dt>

     <dd>

      <p class="para">
       open 回调函数类似于类的构造函数，
       在会话打开的时候会被调用。
       这是自动开始会话或者通过调用 <span class="function"><a href="session_start.html" class="function">session_start()</a></span> 手动开始会话
       之后第一个被调用的回调函数。
       此回调函数操作成功返回 <strong><code>TRUE</code></strong>，反之返回 <strong><code>FALSE</code></strong>。
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">close()</code></dt>

     <dd>

      <p class="para">
       close 回调函数类似于类的析构函数。
       在 write 回调函数调用之后调用。
       当调用 <span class="function"><a href="session_write_close.html" class="function">session_write_close()</a></span> 函数之后，也会调用 close 回调函数。
       此回调函数操作成功返回 <strong><code>TRUE</code></strong>，反之返回 <strong><code>FALSE</code></strong>。
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">read(string $sessionId)</code></dt>

     <dd>

      <p class="para">
       如果会话中有数据，read 回调函数必须返回将会话数据编码（序列化）后的字符串。
       如果会话中没有数据，read 回调函数返回空字符串。
      </p>
      <p class="para">
       在自动开始会话或者通过调用
       <span class="function"><a href="session_start.html" class="function">session_start()</a></span> 函数手动开始会话之后，PHP 内部调用 read 回调函数来获取会话数据。
       在调用 read 之前，PHP 会调用 open 回调函数。
      </p>
      <p class="para">
       read 回调返回的序列化之后的字符串格式必须与 <code class="parameter">write</code> 回调函数保存数据时的格式完全一致。
       PHP 会自动反序列化返回的字符串并填充 <var class="varname"><var class="varname"><a href="reserved.variables.session.html" class="classname">$_SESSION</a></var></var> 超级全局变量。
       虽然数据看起来和 <span class="function"><a href="serialize.html" class="function">serialize()</a></span> 函数很相似，
       但是需要提醒的是，它们是不同的。
       请参考： <a href="session.configuration.html#ini.session.serialize-handler" class="link">session.serialize_handler</a>。
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">write(string $sessionId, string $data)</code></dt>

     <dd>

      <p class="para">
       在会话保存数据时会调用 <code class="parameter">write</code> 回调函数。
       此回调函数接收当前会话 ID 以及 <var class="varname"><var class="varname"><a href="reserved.variables.session.html" class="classname">$_SESSION</a></var></var> 中数据序列化之后的字符串作为参数。
       序列化会话数据的过程由 PHP 根据 <a href="session.configuration.html#ini.session.serialize-handler" class="link">session.serialize_handler</a> 设定值来完成。
      </p>
      <p class="para">
       序列化后的数据将和会话 ID 关联在一起进行保存。
       当调用 <code class="parameter">read</code> 回调函数获取数据时，所返回的数据必须要和
       传入 <code class="parameter">write</code> 回调函数的数据完全保持一致。
      </p>
      <p class="para">
       PHP 会在脚本执行完毕或调用 <span class="function"><a href="session_write_close.html" class="function">session_write_close()</a></span> 函数之后调用此回调函数。
       注意，在调用完此回调函数之后，PHP 内部会调用 <code class="parameter">close</code> 回调函数。
       <blockquote class="note"><p><strong class="note">Note</strong>: 
        <p class="para">
         PHP 会在输出流写入完毕并且关闭之后
         才调用 write 回调函数，
         所以在 write 回调函数中的调试信息不会输出到浏览器中。
         如果需要在 write 回调函数中使用调试输出，
         建议将调试输出写入到文件。
        </p>
       </p></blockquote>
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">destroy($sessionId)</code></dt>

     <dd>

      <p class="para">
       当调用 <span class="function"><a href="session_destroy.html" class="function">session_destroy()</a></span> 函数，
       或者调用  <span class="function"><a href="session_regenerate_id.html" class="function">session_regenerate_id()</a></span> 函数并且设置 destroy 参数为 <strong><code>TRUE</code></strong> 时，
       会调用此回调函数。此回调函数操作成功返回 <strong><code>TRUE</code></strong>，反之返回 <strong><code>FALSE</code></strong>。
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">gc($lifetime)</code></dt>

     <dd>

      <p class="para">
       为了清理会话中的旧数据，PHP 会不时的调用垃圾收集回调函数。
       调用周期由 <a href="session.configuration.html#ini.session.gc-probability" class="link">session.gc_probability</a> 
       和 <a href="session.configuration.html#ini.session.gc-divisor" class="link">session.gc_divisor</a> 参数控制。
       传入到此回调函数的 lifetime 参数由 <a href="session.configuration.html#ini.session.gc-maxlifetime" class="link">session.gc_maxlifetime</a> 设置。
       此回调函数操作成功返回 <strong><code>TRUE</code></strong>，反之返回 <strong><code>FALSE</code></strong>。
      </p>
     </dd>

       
    
     <dt>
<code class="parameter">create_sid()</code></dt>

     <dd>

      <p class="para">
       当需要新的会话 ID 时被调用的回调函数。
       回调函数被调用时无传入参数，
       其返回值应该是一个字符串格式的、有效的会话 ID。
      </p>
     </dd>

    
   </dl>

  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.session-set-save-handler-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="para">
   成功时返回 <strong><code>TRUE</code></strong>， 或者在失败时返回 <strong><code>FALSE</code></strong>。
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.session-set-save-handler-examples">
  <h3 class="title">范例</h3>
  <p class="para">
   <div class="example" id="example-5838">
    <p><strong>Example #1 
     自定义会话管理器： 完整代码请参见 <a href="class.sessionhandlerinterface.html" class="classname">SessionHandlerInterface</a>。
    </strong></p>
    <div class="example-contents"><p>
     下列代码适用于 PHP 5.4.0 及以上版本。
     这里仅列出了调用方式，完整代码请参见 <a href="class.sessionhandlerinterface.html" class="classname">SessionHandlerInterface</a>。
    </p></div>
    <div class="example-contents"><p>
     这里使用了 <span class="function"><strong>session_set_save_handler()</strong></span> 函数的 OOP 原型
     并且使用第二个参数来注册 shutdown 函数。
     当将对象注册为会话保存管理器时，建议使用这种方式。
    </p></div>
    <div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class&nbsp;</span><span style="color: #0000BB">MySessionHandler&nbsp;</span><span style="color: #007700">implements&nbsp;</span><span style="color: #0000BB">SessionHandlerInterface<br /></span><span style="color: #007700">{<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #FF8000">//&nbsp;在这里实现接口<br /></span><span style="color: #007700">}<br /><br /></span><span style="color: #0000BB">$handler&nbsp;</span><span style="color: #007700">=&nbsp;new&nbsp;</span><span style="color: #0000BB">MySessionHandler</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">session_set_save_handler</span><span style="color: #007700">(</span><span style="color: #0000BB">$handler</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">true</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">session_start</span><span style="color: #007700">();<br /><br /></span><span style="color: #FF8000">//&nbsp;现在可以使用&nbsp;$_SESSION&nbsp;保存以及获取数据了</span>
</span>
</pre></div>
    </div>

   </div>
   <div class="example" id="example-5839">
    <p><strong>Example #2 使用对象自定义会话保存管理器</strong></p>
    <div class="example-contents"><p>
     下列代码适用于 PHP 5.4.0 之前的版本。
    </p></div>
    <div class="example-contents"><p>
     下例演示了基于文件的会话数据存储，
     和 PHP 默认的  <code class="parameter">files</code> 存储器很相似。
     通过对此示例代码进行扩展，
     你可以很方便的实现使用数据库保存会话数据的功能。
    </p></div>
    <div class="example-contents"><p>
     针对于 PHP 5.4.0 之前的版本，
     通过调用 <span class="function"><a href="register_shutdown_function.html" class="function">register_shutdown_function()</a></span> 函数
     来注册 <span class="function"><a href="session_write_close.html" class="function">session_write_close()</a></span> 回调函数。
     这也是我们建议的方式。
    </p></div>
    <div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class&nbsp;</span><span style="color: #0000BB">FileSessionHandler<br /></span><span style="color: #007700">{<br />&nbsp;&nbsp;&nbsp;&nbsp;private&nbsp;</span><span style="color: #0000BB">$savePath</span><span style="color: #007700">;<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;function&nbsp;</span><span style="color: #0000BB">open</span><span style="color: #007700">(</span><span style="color: #0000BB">$savePath</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$sessionName</span><span style="color: #007700">)<br />&nbsp;&nbsp;&nbsp;&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">savePath&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">$savePath</span><span style="color: #007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(!</span><span style="color: #0000BB">is_dir</span><span style="color: #007700">(</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">savePath</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">mkdir</span><span style="color: #007700">(</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">savePath</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">0777</span><span style="color: #007700">);<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;</span><span style="color: #0000BB">true</span><span style="color: #007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;}<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;function&nbsp;</span><span style="color: #0000BB">close</span><span style="color: #007700">()<br />&nbsp;&nbsp;&nbsp;&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;</span><span style="color: #0000BB">true</span><span style="color: #007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;}<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;function&nbsp;</span><span style="color: #0000BB">read</span><span style="color: #007700">(</span><span style="color: #0000BB">$id</span><span style="color: #007700">)<br />&nbsp;&nbsp;&nbsp;&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;(string)@</span><span style="color: #0000BB">file_get_contents</span><span style="color: #007700">(</span><span style="color: #DD0000">"</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">savePath</span><span style="color: #DD0000">/sess_</span><span style="color: #0000BB">$id</span><span style="color: #DD0000">"</span><span style="color: #007700">);<br />&nbsp;&nbsp;&nbsp;&nbsp;}<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;function&nbsp;</span><span style="color: #0000BB">write</span><span style="color: #007700">(</span><span style="color: #0000BB">$id</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$data</span><span style="color: #007700">)<br />&nbsp;&nbsp;&nbsp;&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;</span><span style="color: #0000BB">file_put_contents</span><span style="color: #007700">(</span><span style="color: #DD0000">"</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">savePath</span><span style="color: #DD0000">/sess_</span><span style="color: #0000BB">$id</span><span style="color: #DD0000">"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$data</span><span style="color: #007700">)&nbsp;===&nbsp;</span><span style="color: #0000BB">false&nbsp;</span><span style="color: #007700">?&nbsp;</span><span style="color: #0000BB">false&nbsp;</span><span style="color: #007700">:&nbsp;</span><span style="color: #0000BB">true</span><span style="color: #007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;}<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;function&nbsp;</span><span style="color: #0000BB">destroy</span><span style="color: #007700">(</span><span style="color: #0000BB">$id</span><span style="color: #007700">)<br />&nbsp;&nbsp;&nbsp;&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">$file&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #DD0000">"</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">savePath</span><span style="color: #DD0000">/sess_</span><span style="color: #0000BB">$id</span><span style="color: #DD0000">"</span><span style="color: #007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(</span><span style="color: #0000BB">file_exists</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">unlink</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">);<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;</span><span style="color: #0000BB">true</span><span style="color: #007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;}<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;function&nbsp;</span><span style="color: #0000BB">gc</span><span style="color: #007700">(</span><span style="color: #0000BB">$maxlifetime</span><span style="color: #007700">)<br />&nbsp;&nbsp;&nbsp;&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;foreach&nbsp;(</span><span style="color: #0000BB">glob</span><span style="color: #007700">(</span><span style="color: #DD0000">"</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">savePath</span><span style="color: #DD0000">/sess_*"</span><span style="color: #007700">)&nbsp;as&nbsp;</span><span style="color: #0000BB">$file</span><span style="color: #007700">)&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(</span><span style="color: #0000BB">filemtime</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">)&nbsp;+&nbsp;</span><span style="color: #0000BB">$maxlifetime&nbsp;</span><span style="color: #007700">&lt;&nbsp;</span><span style="color: #0000BB">time</span><span style="color: #007700">()&nbsp;&amp;&amp;&nbsp;</span><span style="color: #0000BB">file_exists</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">unlink</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">);<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;</span><span style="color: #0000BB">true</span><span style="color: #007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;}<br />}<br /><br /></span><span style="color: #0000BB">$handler&nbsp;</span><span style="color: #007700">=&nbsp;new&nbsp;</span><span style="color: #0000BB">FileSessionHandler</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">session_set_save_handler</span><span style="color: #007700">(<br />&nbsp;&nbsp;&nbsp;&nbsp;array(</span><span style="color: #0000BB">$handler</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'open'</span><span style="color: #007700">),<br />&nbsp;&nbsp;&nbsp;&nbsp;array(</span><span style="color: #0000BB">$handler</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'close'</span><span style="color: #007700">),<br />&nbsp;&nbsp;&nbsp;&nbsp;array(</span><span style="color: #0000BB">$handler</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'read'</span><span style="color: #007700">),<br />&nbsp;&nbsp;&nbsp;&nbsp;array(</span><span style="color: #0000BB">$handler</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'write'</span><span style="color: #007700">),<br />&nbsp;&nbsp;&nbsp;&nbsp;array(</span><span style="color: #0000BB">$handler</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'destroy'</span><span style="color: #007700">),<br />&nbsp;&nbsp;&nbsp;&nbsp;array(</span><span style="color: #0000BB">$handler</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'gc'</span><span style="color: #007700">)<br />&nbsp;&nbsp;&nbsp;&nbsp;);<br /><br /></span><span style="color: #FF8000">//&nbsp;下面这行代码可以防止使用对象作为会话保存管理器时可能引发的非预期行为<br /></span><span style="color: #0000BB">register_shutdown_function</span><span style="color: #007700">(</span><span style="color: #DD0000">'session_write_close'</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">session_start</span><span style="color: #007700">();<br /></span><span style="color: #FF8000">//&nbsp;现在可以使用&nbsp;$_SESSION&nbsp;保存以及获取数据了</span>
</span>
</pre></div>
    </div>

   </div>
  </p>
 </div>


 <div class="refsect1 notes" id="refsect1-function.session-set-save-handler-notes">
  <h3 class="title">注释</h3>
  <div class="warning"><strong class="warning">Warning</strong>
   <p class="para">
    在脚本执行完毕之后，PHP 内部会清除对象，
    所以有可能不调用 <code class="parameter">write</code> 和 <code class="parameter">close</code> 回调函数。
    这样可能会引发非预期的行为，所以当使用对象作为会话保存管理器时，
    需要通过注册 shutdown 回调函数来规避风险。
    通常，你可以通过调用 <span class="function"><a href="register_shutdown_function.html" class="function">register_shutdown_function()</a></span> 函数
    来注册 <code class="parameter">&#039;session_write_close&#039;</code> 回调函数。
   </p>
   <p class="para">
    在 PHP 5.4.0 中，可以调用 <span class="function"><a href="session_register_shutdown.html" class="function">session_register_shutdown()</a></span> 
    函数来注册 shutdown 回调函数。
    如果你使用 <span class="function"><strong>session_set_save_handler()</strong></span> 的 OOP 原型，
    那么仅需设置 “register shutdown” 为 <strong><code>TRUE</code></strong> 即可。
   </p>
  </div>
  <div class="warning"><strong class="warning">Warning</strong>
   <p class="para">
    在 PHP 5.0.5 中，在对象销毁之后才会调用
    <code class="parameter">write</code> 和 <code class="parameter">close</code> 回调函数，
    所以，在这两个回调函数中不可以使用对象，也不可以抛出异常。
    如果在函数中抛出异常，PHP 既不会捕获它，也不会跟踪它，
    这样会导致程序异常终止。
    但是对象析构函数可以使用会话。
   </p>
   <p class="para">
    可以在析构函数中调用  <span class="function"><a href="session_write_close.html" class="function">session_write_close()</a></span>  
    函数来解决这个问题。
    但是注册 shutdown 回调函数才是更加可靠的做法。
   </p>
  </div>
  <div class="warning"><strong class="warning">Warning</strong>
   <p class="para">
    如果会话在脚本结束后关闭，对于某些 SAPI 而言，当前工作目录可能已经被改变。
    可以调用 <span class="function"><a href="session_write_close.html" class="function">session_write_close()</a></span> 
    函数在脚本执行结束之前关闭会话。
   </p>
  </div>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.session-set-save-handler-changelog">
  <h3 class="title">更新日志</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>版本</th>
      <th>说明</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>7.0.0</td>
      <td>
       新增可选参数 <code class="parameter">validate_sid</code> 和
       参数 <code class="parameter">update_timestamp</code>。
      </td>
     </tr>

     <tr>
      <td>5.5.1</td>
      <td>
       加入可选参数 <code class="parameter">create_sid</code>。
      </td>
     </tr>

     <tr>
      <td>5.4.0</td>
      <td>
       加入 <span class="interfacename"><a href="class.sessionhandlerinterface.html" class="interfacename">SessionHandlerInterface</a></span> 接口以及
       <a href="class.sessionhandler.html" class="classname">SessionHandler</a> 类，以方便用户实现自定义的会话保存管理器。
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 seealso" id="refsect1-function.session-set-save-handler-seealso">
  <h3 class="title">参见</h3>
  <p class="para">
   <ul class="simplelist">
    <li class="member">
     <a href="session.configuration.html#ini.session.save-handler" class="link">session.save_handler</a>
     配置指示
    </li>
    <li class="member">
     <a href="session.configuration.html#ini.session.serialize-handler" class="link">session.serialize_handler</a>
     配置指示
    </li>
    <li class="member"><span class="function"><a href="register_shutdown_function.html" class="function" rel="rdfs-seeAlso">register_shutdown_function()</a> - 注册一个会在php中止时执行的函数</span></li>
    <li class="member"><span class="function"><a href="session_register_shutdown.html" class="function" rel="rdfs-seeAlso">session_register_shutdown()</a> - 关闭会话</span> PHP 5.4.0+</li>
    <li class="member">
     完整的实现请参考 
     <a href="https://github.com/php/php-src/blob/master/ext/session/tests/save_handler.inc" class="link external">&raquo;&nbsp;save_handler.inc</a>。
    </li>
   </ul>
  </p>
 </div>


</div></div></div></body></html>